<html>
<head>

<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta http-equiv="Content-Language" content="en-us">
<meta name="Keywords" content="Zekr, open source quranic project">
<meta name="Name" content="Zekr FAQ">

<link href="site-style.css" type="text/css" rel="StyleSheet">
<link rel="shortcut icon" type="image/x-icon" href="img/favicon.ico">

<title>Zekr FAQ</title>

</head>

<body
	style="background: url('img/zekr.jpg') fixed center center no-repeat">

<table width="100%" border="0">
	<tr>
		<td width="80%">
		<h1>Zekr FAQ</h1>
		</td>
		<td align="right" width="20%">
			<a href="./"><img src="img/zekr-logo-small.png" alt="Zekr small logo"></a>
		</td>
	</tr>

</table>
<i> Frequently Asked Questions of the Zekr project. </i>
<br>
<br>

<h3>[General]</h3>
<div class="question">What is Zekr?</div>
<div class="answer">Zekr is an open platform for working and research on the Holy
Quran. For more details its current state and road map see Zekr 1.0 plan <a
	href="plan.html">here</a>. Please also see the <a href="glossary.html">glossary</a>
	of common Quranic terms used here and in software.
</div>

<div class="question">What does Zekr mean?</div>
<div class="answer">Zekr is a name for the Holy Quran (in Quran terms).
Linguistically, it means "note", "reminder" or "message". More clearly,
Quran is a reminder for the human morality.<br>
(12-104), (38-87), (81-27) "<span style="font: 16pt traditional arabic">إِنْ هُوَ إِلاَّ ذِكْرٌ لِّلْعَالَمِينَ</span>" meaning:
<i>It is no less than a message for all creatures</i> (A. Yusufali).<br>
(68-52) "<span style="font: 16pt traditional arabic">وَمَا هُوَ إِلَّا ذِكْرٌ لِّلْعَالَمِينَ</span>" meaning:
<i>But it is nothing less than a Message to all the worlds</i> (A. Yusufali).

</div>

<div class="question">Where is the homepage?</div>
<div class="answer">The main homepage for Zekr is <a href="http://zekr.org" title="Zekr main homapage">
http://zekr.org</a>. It's also hosted on <a href="http://sourceforge.net/projects/zekr">SourceForge.net</a>,
where you can find the latest releases as well as an archive of previous releases. You can also fill bug reports
of feature requests there, or access to the source code from CVS.
</div>

<div class="question">How can I contribute?</div>
<div class="answer">Pleas see the participation page <a href="participation.html">here</a>.</div>

<div class="question">Who develops it?</div>
<div class="answer">Zekr is originally written and being developed by <a
	href="http://khorshid.ut.ac.ir/~saboorian">Mohsen Saboorian</a> (<a href="http://saboorian.blogspot.com">weblog</a>).
These peoples also helped with language packs and useful feedbacks:
<ul>
	<li>Ari R. Fikri (Indonesian language pack)</li>
	<li>Younes Moumen (Basic French and Arabic language packs)</li>
	<li>Riyad Preukschas (German language pack)</li>
	<li>Michael Kalinin (Russian language pack + Russian translations)</li>
	<li>Omar sm (Critical typo reports)</li>
	<li>Aydin Tarık Zengin (Turkish language pack + Turkish translation)</li>
	<li>H N Jafar (Malay language pack)</li>
	<li>Erik van Luxzenburg (Initial Dutch language pack)</li>
	<li>Muhammad Bashir Al-Noimi (Arabic language pack)</li>
	<li>Dangiislam.org (Kurdish language pack)</li>
	<li>Mohsin Shafeeque Hijazee (Urdu language pack)</li>
	<li>Nedim Hadžić (Bosnian language pack)</li>
	<li>Alma Aganović (Help on Bosnian language pack + Korkut translation)</li>
	<li>Johan Laenen (Dutch language pack)</li>
	<li>Zabeehkhan (Pashto language pack)</li>
	<li>Fareed A. Bashirov (Tatar language pack + Tatar translation)</li>
	<li>Mohammad Mehdi Saboorian (useful feedbacks)</li>
	<li><a href="http://irmug.org">Ali Rastegar</a> (Mac port + Mac maintainer)</li>
	<li><a href="http://www.iqc.ca/~mderakhshani/">Mohammad Derakhshani</a> (Ubuntu package maintainer)</li>
	<li><a href="http://www.cs.uwaterloo.ca/~hzarrabi/">Hamid Zarrabi-Zadeh</a> (Quran text automatic verification)</li>
</ul>
</div>

<div class="question">Why are you working on Zekr?</div>
<div class="answer">There is not a really nice and standard platform for
Quran related topics. There are some software which are fully
commercial, others are free-commercial but still with no source code. I
really couldn't find an easy-to-use, free and popular Quranic platform.
If you know one, please let <a href="contact.html">me</a> know :)</div>

<div class="question">What is the license?</div>
<div class="answer">For now, GNU GPL. You can find more information
about licenses on <a href="relnotes.html">release notes</a> page.</div>

<div class="question">How can I find more information?</div>
<div class="answer">You can contact me <a href="contact.html">here</a>.</div>

<h3>[Problems]</h3>
<div class="question">

<a name="uee" class="noLink">I'm facing with this Exception: <i>java.io.UnsupportedEncodingException: Cp1256</i>.
What should I do for solving this?</a></div>
<div class="answer">
The reason to this may be that you didn't customized your <acronym title="Java Runtime Environment">JRE</acronym> installation to support non-European languages.
In Windows platforms, if your computer locale is not Arabic, when installing JRE, you should check 
all components (including non-European fonts and encoding support) to be installed.<br>
<br>
Some notes from JDK 5.0 Documentation (Supported Encodings):<br>
<b>Sun's J2SE Development Kit 5.0</b> for all platforms (Solaris<sup><FONT SIZE="-2">TM</FONT></sup> 

operating environment, Linux, and Microsoft Windows) and the J2SE Runtime Environment 5.0 for 
<b>Solaris and Linux</b> support all encodings...<br>
Sun's J2SE Runtime Environment 5.0 for Windows 
<b>may be installed as a complete international version or as a European languages version</b>.
The JRE installer by default installs a European languages version if it recognizes that the host 
operating system only supports European languages. If the installer recognizes that any other 
language is needed, or <b>if the user requests support for non-European languages in a 
customized installation</b>, a complete international version is installed... 
The international version (which includes the <tt>lib/charsets.jar</tt> file) supports all encodings...
<br><br>
So, you can either reinstall you JRE (<b>customized</b>, this time), or install a JDK.
</div>

<div class="question">Other kinds of startup problems</div>
<div class="answer">
There may be some problems with Zekr startup or something similar. If you cannot start Zekr, please 
make sure that the problem is not about your configuration.
Please remove <tt>~/.zekr</tt> folder (or <tt>[Documents and Settings\username\].zekr</tt> on Windows)
and start the zekr again.
If this doesn't fix the problem, <a href="contact.html">send me</a> the log file <tt>~/.zekr/zekr.log</tt>.
</div>

<div class="question">I have a Java 6.0 on my machine, but ...</div>
<div class="answer">
Versions prior to 0.5.0 beta 1, might not work on Java 6.0. However this could be fixed if you copy
Zekr somewhere without any space characters in the path.
</div>

<div class="question">Which language packs do Zekr have?</div>
<div class="answer">See <a href="http://groups.google.com/group/zekr/files">this page</a> 
for a list of latest updated language packs. Currently we have 
Arabic, Dutch, English, French, German, Indonesian, Kurdish, Malay, Russian, Turkish, Persian, Pashto and Urdu
language packs. Please help us adding your own language pack to Zekr.
</div>

<h3>[Development]</h3>
<div class="question">What is Zekr written in?</div>
<div class="answer">Zekr is written in Java (JDK 1.4+ compliant). It is
developed in <a href="http://eclipse.org">Eclipse</a> platform (3.0 Mx to
3.3.1).</div>

<div class="question">What is the GUI/Widget library used for its?</div>
<div class="answer">Zekr is fully developed on <a
	href="http://www.eclipse.org/swt" title="Standard Widget Toolkit">SWT</a>.
It currenly supports bidirectional rendering, only on Windows and Linux.
The BIDI support for Mac is limited to single widgets only, and composites and groups are not supported.
</div>

<div class="question">Where is the source code?</div>
<div class="answer">
Latest Zekr source code may always be available on SourceForge.net CVS. Use
<a href="http://zekr.cvs.sourceforge.net/zekr">this</a> URL for web based CVS tree and 
<a href="http://sourceforge.net/cvs/?group_id=128414">this one</a> for checkout instructions.
</div>

<div class="question">Why Java?</div>
<div class="answer">
Simply because I know Java more than C++!<br>
In adition it is cross platform, easy and open. I used 
<a href="http://www.eclipse.org/swt">SWT</a> because it is a nice looking
native widget toolkit and has a number of advantages over Swing (More fast, more cool, more easy use).
</div>

<div class="question">Other platforms</div>
<div class="answer">
By now, it can be run on <i>Windows</i>, <i>Linux</i>, and <i>Mac OS</i>.
I did only test it on 32-bit architectures. From Zekr 0.6.0 beta 1, we may always have a 64-bit distribution for Linux.
</div>

<div class="question"><a name="linux" class="noLink">Do you Linux?</a></div>
<div class="answer">
Yes! Zekr ported to Linux from version 0.2.0.
You should first download and install a Mozilla GTK2 (1.4+)
browser from <a href="http://www.mozilla.org">mozilla.org</a>. You can download 
<a href="http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7.3/contrib/mozilla-i686-pc-linux-gnu-1.7.3-gtk2+xft.tar.gz">Mozilla 1.7.3 GTK2</a>
from Mozilla.org.<br /><br />

Please see <a href="wiki/Installation">this Wiki page</a> for more info about installation instructions.

<br /><br />
Please remember where the Mozilla in installed (e.g. /usr/local/mozilla), 
and check if there is a <tt>components</tt> folder inside the mozilla home directory. 
You should set an environment variable <tt>MOZILLA_FIVE_HOME</tt> to the mozilla home directory.
If there is no <tt>components</tt> folder inside mozilla home, check <tt>[mozilla home]/lib</tt>, and if there
was such a folder, set the environment variable to this location.<br>
On my Open Source SuSE 10.0, mozilla is installed on <tt>/opt/mozilla</tt>,
but the main folder is <tt>/opt/mozilla/lib</tt> where components folder can be found.<br><br>
After all, you can run <tt>[zekr]/linux-run.sh</tt> to launch the Zekr platform.
<br><br>
<div class="question"><a name="ubuntu" class="noLink">Do you Ubuntu?</a></div>
<div class="answer">
From version 0.4.0, there would be always .deb Ubuntu packages for Zekr on its download page. This installer
automatically detects and forces you to install prerequisites from Ubuntu repository.
<br>
From version 0.5.0 an online repository for Ubuntu/Debian is running. For more information see the <a href="apt">Ubuntu/Debian HowTo</a>.
</div>
</div>

<div class="question"><a name="gcj" class="noLink">I have problems running Zekr on Linux?</a></div>
<div class="answer">
Make sure that you have carefully done these steps:
<ol>
<li>Set an environment variable "<tt>MOZILLA_FIVE_HOME</tt>", which refers to your Mozilla GTK2 1.4+ installation 
	(Firefox can also be used if your distribution brings it with linkable Gecko libraries. Redhat 
	distributions for example does that).</li>
<li><tt>java</tt> should be set in your path. Please make sure that the <acronym title="Java Runtime Environment">JRE</acronym> you are using is not <tt>GCJ</tt>/<tt>GIJ</tt>.
	<tt>GCJ</tt>/<tt>GIJ</tt> (GNU's native Java) is not a standard Java, hence not Java 1.4+ compaliant.</li>
</ol>
</div>

<div class="question"><a name="mac" class="noLink">Do you also Mac?</a></div>
<div class="answer">
Yes, Zekr also works fine on Mac. Special thanks to Ali Rastegar for his porting and maintainance of the Mac version.<br>
It looks quite like Linux GTK. The only difference is that there would 
be no bit of bother to set any environmet variable. Safari is used as default browser.
For running Zekr on Mac, you should unzip Zekr package and run mac-run.sh.<br>
<br>
From Zekr 0.4.0 the download package is a Mac Application Bundle (which brings more ease of use for Mac users).
Many thanks to Ali Rastegar for his helps.
</div>

<h3>[Install]</h3>

<div class="question">Howto install Zekr on my machine?</div>
<div class="answer">
<br />
<b><a href="wiki/Installation">Find the answer on Wiki.</a></b>
<ul>
<li><b>Windows</b>: Zekr is tested on Win 2000 and XP and Vista. Windows package has a simple installer.
After installation, you can find Zekr on your programs section in "Start Menu".</li>
<li><b>Linux</b>: For Debian-friendly editions, you can use our .deb installer package, but make sure first to
uninstall any previously Zekr installation on your system (Ubuntu example): <code>sudo dpkg --purge zekr</code>.
You can then install Zekr with the following command line (Ubuntu example): <code>sudo dpkg -i zekr_[VERSION_DETAIL]_i386.deb</code>.<br>

There is also an <b><a href="apt">apt repository</a></b> available for Debian.
Use instructions on <a href="apt">this page</a> to add it to your update site list.
If you are using other distributions such as Fedora or SuSE, simply use .tar.gz distribution, but set your
Mozilla installation manually in <code>linux-run.sh</code>.</li>
<li><b>Mac</b>: <i>TBD</i></li>
<li><b>Other platforms:</b> which platform you exactly mean?</li>
</ul>
<br>

See the full download archive at <a href="http://sourceforge.net/project/showfiles.php?group_id=128414">SourceForge.net</a>.
</div>

<h3>[More!]</h3>
<div class="question">Have more questions? <a href="contact.html">Ask us</a>!
</div>



<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
<script type="text/javascript">_uacct = "UA-336966-1";urchinTracker();</script>

<script language="JavaScript" type="text/javascript" src="stat.js"></script>
<script language="JavaScript" type="text/javascript">persianstat(10004449, 0);</script>


</body>
</html>
